Preview links (active after the build_preview check completes)

Modified Files

• https://docs-staging.datadoghq.com/patrickliang/add-warning-on-upgrading-datadog-operator-1.28/containers/kubernetes/csi_driver

/review

Thanks for the PR, I've left a couple of suggestions.

Additionally, the new warning div sits directly alongside an existing warning div (screenshot):

This creates a visually jarring experience, and users might miss important information. One potential resolution would be to add a sub-heading before the new warning div, possible something like: #### Upgrade and migration notes.

Let me know if that works. If not, it may be more expedient to create a card on the DOCS board to have someone from the team investigate the best presentation for this information.

Also feel free to let me know if you have any questions.

Hey @buraizu
Thanks for the feedback!
I've made a commit to add a sub-heading, let me know if that works or need me to adjust anything else!

Thanks for applying that feedback @mrdoggopat. Taking another look, I think there's a bit of additional room for improvement for both human readers and AI retrieval alike. Here's the rationale:

1. The two blocks aren't the same severity. The upgrade block is a genuine caution — if you don't act, the Operator can't reconcile — so it should stay as a warning callout. The Helm migration block is guidance, not danger (one of its paths is literally "No action is required"), so styling it as a red warning overstates it. That mismatch is the real source of the visual friction: two identical red blocks where only one is actually a warning.
   As such, I'm suggesting to give each topic its own #### heading, keep the upgrade known-issue as the single warning callout, and present the Helm migration as plain prose with a bulleted list. That leaves one red block instead of two, and the prose treatment matches how the rest of the page handles substantial procedural content.
2. Because each block now has its own heading, both sections get anchor links. You can point users (or other docs) directly to the upgrade workaround or the Helm migration steps, which isn't possible while they're anonymous divs.

I built this locally to check the rendering, and attached a screenshot below, along with the updated markdown content.

Since I'm not able to make a suggestion on the "Migrating from Helm-based CSI Driver installation" div, you'll have to change that as well in your feature branch if you decide to apply this update. If you'd prefer, I can also make this commit directly to your branch — just let me know how you'd like to proceed.

Thanks again for following up, and let me know if you have any questions!

I think that's fine! As my change is more of a warning anyway.